.. _cmlGnLoadDevice:

cmlGnLoadDevice
================================
--------------------------------


SYNOPSYS
`````````````
.. code-block:: none

    VT_I4 cmlGnLoadDevice ([out] VT_PI4 NumDevices, [out] VT_PI4 BoardIDList, 
    [out] VT_PI4 NumServos) 

DESCRIPTION
`````````````  

- 시스템에 설치된 하드웨어 장치를 로드하고 장치를 초기화합니다. 이 함수는 ComiMLink2의 
  다른 함수가 호출되기전에 반드시 한번은 수행되어야 합니다. 일반적으로 프로그램의 
  시작부분에서 수행해주면 됩니다.    

\

- 이 함수의 사용과 호출에 있어, 제공된 ㈜커미조아의 함수 헤더 파일에서는 Boland 社의 
  Delphi나 Microsoft 社의 Visual Basic 에서는 명시적으로 이 동작이 이루어지기 때문에 
  필요하지 않습니다. 


PARAMETER
```````````````

▶NumDevices:이매개변수를통하여실제로로드(Load)된네트워크모션보드의개수를반환합니 
다. 단, 이매개변수에 NULL 을전달하면보드개수를반환하지않습니다. 
 
▶BoardIDList:이매개변수를통하여실제로로드(Load)된네트워크모션보드의 ID 
배열을반환합니다. 단, 이매개변수에 NULL 을전달하면보드 ID 배열을반환하지않습니다. 
 
▶NumServos:이매개변수를통하여실제로로드(Load)된서보드라이브의개수를반환합니다.  
단, 이매개변수에 NULL 을전달하면제어축수를반환하지않습니다.

RETURN VALUE 
`````````````````

  .. csv-table::
   :widths: 10 90
   :header-rows: 1
   :stub-columns: 0

   Value, Meaning 
   음수, 수행 실패
   ERR_NONE, 수행 성공 

EXAMPLE
`````````````

.. code-block:: c++
 :linenos:
 :emphasize-lines: 5

    C/C++ 
 
    #include “ComiMLink2_SDK.h” 
    #include “ComiMLink2_SDK_Def.h” 
    
    #include “ComiMLink2_SDK_Def.h” 
    void ProgramInitial(void) 
    { 
    long nNumDevices = 0; 
    long DeviceList[16] = {0, }; 
    long nNumAxes = 0; 
    if ( cmlLoadDll() != TRUE ) { 
    /* OutputDebugString API 는 GUI 프로그램에서 문자열을 디버거에 보낼 수 있습니다. Borland 
    C++ Builder 에서는 DebugWindows에 Event Log 를  확인(確認)할 수 있으며, MS VC++ 에서는 
    Debug 윈도우에서 확인(確認)할 수 있습니다. */ 
    long BoardID = 0; 
    OutputDebugString(“DLL 로드에 실패하였습니다”); 
    // 이후 적절한 에러처리를 해주시기 바랍니다. 
    } 
    if cmlGnLoadDevice (&nNumDevices, DeviceList, &nNumAxes) != ERR_NONE ){ 
    // 에러메시지 출력 
    } 
    } /* ProgramInitial(void) 함수의 끝 */ 

.. code-block:: c++
 :linenos:
 :emphasize-lines: 5

    Visual Basic 

    „ Visual Basic 에서는 명시적인 DLL 로드가 필요 없습니다. 
    Private Sub Form_Load() 
    Dim IRetVal As Long 
    Dim nTotalDevices As Long 
    Dim DeviceList(16) As Long 
    Dim nTotalAxes As Long 
    IRetVal = GnLoadDevice (nTotalDevices, DeviceList(0), nTotalAxes) 
    If  IRetVal <> ERR_NONE Then 
    MsgBox(“cmlGnLoadDevice has been failed”) 
    End If 
    End Sub 

.. code-block:: c++
 :linenos:
 :emphasize-lines: 5

    Delphi 

    //* Delphi 에서는 명시적인 DLL 로드가 필요없습니다. 
    //* 단, 처음 선언시에 다음과 같은 내용이 포함되어야 합니다. 
    ///////////////////////////////////////////////////////////// 
    // COMZIOA SDK Library 를 위한 인터페이스 파일을 사용합니다. 
    uses ComiMLink2;
    //////////////////////////////////////////////////////////// 
    procedure TForm1.OnCreate(Sender: TObject); 
    var 
    g_nDevs : LongInt; 
    DevList : Array[0..15] of LongInt 
    g_nAxes : LongInt; 
    begin 
    if ( cmlGnLoadDevice (@g_nDevs, @DevList, @g_nAxes) <> ERR_NONE ) then 
    begin 
    // 에러메시지 출력 
    exit; 
    end; 
    end; 


SEE ALSO
```````````````

.. seealso:: :ref:`cmlGnUnloadDevice`